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Preface 


This User's Guide describes the operation and use of the 
System Self-Test and CObug firmware packages. Designed for 
use with both diskette and disk-based Codex Intelligent 
Terminal Systems, System Self-Test and CObug are interactive 
programs which provides users with debugging and basic 
input/output functions. This User's Guide is intended for 
programmers and system development personnel familiar with 
Codex Intelligent Terminal Systems. 


Other Codex literature that may prove useful includes 
the Codex Disk Operating System (CODOS) User's Guide, the 
CODOS Reference Manual, and the Operator's Guides and 
Hardware Reference Manuals appropriate to the user's system. 
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CHAPTER 1. INTRODUCTION 


System Self-Test performs a complete test of Codex 
Intelligent Terminal Systems and their links to system 
peripherals. ,. When power is first applied to the system, 
System Self-Test initializes and tests the systems and its 
components, reinitializes the system, and indicates any 
errors or equipment malfunctions. 


During the system evaluation phase of its operation, 
System Self-Test progressively checks each system component, 
starting with the most basic, and communicates with the 
operator by whatever means are available (for example, if an 
equipment malfunction in the CDX-68 Basic Display Terminal is 
detected, the appropriate error message is printed on the 
system printer). No system component is employed for testing 
purposes until it has been itself tested and found to be 
operating correctly. 


System Self-Test requires minimal operator intervention. 
Under normal conditions, System Self-Test tests system 
operation and loads the Codex Disk Operating System (CODOS) 
into memory. The user can, however, exercise considerable 
control of System Self-Test by using its manual mode. 


System Self-Test resides on a 2K-byte firmware module 
installed on the microcomputer module of the Codex 
Intelligent Terminal System. 

System Self-Test features include: 


* Evaluates and verifies the basic integrity of CDX-68 
Basic Display Terminal-based systems. 


~ Displays any error conditions on the CDX-68 Basic 
Display Terminal display screen or system Enaeme 


* Minimal operator interface requirements. 

* Progressively checks the operation of the various 
parts of the system, starting with the most basic 
components. No portion of the system is used in the 
test until its integrity has been proven. 

* Advises operator of status and prompts operator with 
suggested action whenever testing is held or 
stopped. 


In addition, System Self-Test performs the following 
tests and functions: . 


* Initializes the interrupt jump table. 


* Resets the CDX-68 Basic Display Terminal. 
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* Tests the CDX-68 Basic Terminal RS-232C 
communications link. 


* Provides OP eres for testing keyboard. 


* Tests and initializes firmware scratchpad RAM 
memory. 


* Tests and initializes the bottom 32 bytes of RAM 
used for disk or diskette controller parameters. 


* Provides the option of testing the parallel printer 
- interface link and printing of character set. 


* Tests the selected disk or diskette controller 
firmware PROM. 


* Sizes RAM memory to 32K, 48K, 56K, or 58K bytes and 
displays corresponding memory message. 


* Performs fast random memory test on the remainder of 
RAM memory (20 hex to the sized top-of-memory). 


* Performs read-only tests over the full head-movement 
range (half range for double-sided diskettes) of all 
system disk and diskette drives. 


* Provides optional all- sector read test on all system 
drives. 


* Provides. optional. read/write test on all sectors of 
ready diskette drives or on sectors 23 and 24 of | 
ready disk drives. 


* Prevents operator from loading CODOS when required 
portion of system is inoperable. 


* Provides jump table entry to calculate CRC signature 
over desired memory range and to compare with 
expected values. 


* Provides Jump table entry to generate standard disk 
error messages. 


* Provides 3 jump table entries to keyboard polling 
routines. 


* Provides jump table entry to the routine calculating 
which sector in a multiple disk access was in error. 


* Indicates end-of-test status. 
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Hardware Support Required 


The minimum hardware configuration required to support 
System Self-Test consists of: 


-- CDX-68 Basic Display Terminal with the appropriate 
firmware modules. 


SST also supports a wide variety of optional hardware. 
Additional Hardware Supported | 


System Self-Test supports nearly all Codex Intelligent 
Terminal System hardware components, including disk and 
diskette data storage, up to 36K bytes of memory, anda 
variety of printers. 


a 


Software Support Required 


System Self-Test requires no software support, although 
it is typically used in conjunction with the Codex Disk 
Operating System (CODOS) and the Codex system Berageee 
(CObug). 


Firmware Installation 


System Self-Test resides on a 2K EPROM which pigs 
directly into the Microcomputer Module D of Codex Intelligent 
Terminal Systems. 


To install the System Self-Test EPROM, first remove any 
chip already in socket U14 of the Microcomputer Module D 
circuit board. Place this chip immediately in conductive 
foam in order to prevent damage. Remove the System Self-Test 
EPROM from its conductive foam and plug it into socket U14. 


As with any such discrete component, the System 
Self-Test EPROM is sensitive to damage from improper handling 
and static electricity. The chip should be stored in 
conductive foam when not in place on the circuit board. 
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In normal operation, System Self-Test requires very 
little attention from the operator; however, it can also 
provide a variety of operational tests and commands that 
enhance its testing capabilities. This chapter discusses 
First the automatic test procedures and then each of the 
optional tests. Table 1 describes SST commands; Table 2 
lists SST error messages along with the most likely cause for 
each. 


Automatic Testing Procedures 


SST 1S initialized when power is first applied to the 
CDX-68 Basic Display Terminal and again each time the reset 
Switch (on the Terminal's back cover) is actuated. The 
section Power-On Initialization and Self-Test describes the 
former and Reset Initialization and Self-Test discusses the 
latter. - 


Power-On Initialization and Self-test 


CAUTION! BE SURE THAT THE DOORS ON THE CDX-FS SERIES 
DISKETTE DRIVES ARE OPEN AND THAT NO DISKETTES ARE IN PLACE. 
OTHERWISE, THE CONTENTS OF THE DISKETTE MAY BE DESTROYED WHEN 
POWER IS APPLIED. | | | 


a. With the doors on the diskette drives open and no 
diskettes in the drives, apply power to the CDX-68 
Basic Display Terminal, the CDX-FS Series Diskette 
Storage system, and the CDX-SP Series Printer (if 
attached). System Self-Test initializes the 
system, performs a portion of the selftest routine, 
and, if no errors are detected, displays: 


SYSTEM SELFTEST X.X 
Copyright 1979 by CODEX Corp 


Insert Disk 0 
where X.X is the revision number. 


Note that should SST detect an error, it displays 
the appropriate error message. 
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b. Insert a CODOS system diskette into each diskette 
drive and close the drive doors. SST completes 
the system self-test, reinitializes the system, 
loads the CODOS Disk Operating eee into 
memory, and displays: 


56K memory operational 
END SYSTEM SELFTEST 


CODOS X.X 


Note that the amount of memory indicated by the 
first statement may vary but does not affect SST 
Operation; also the CODOS version number may be 
different without affecting SST operation. 


In the above screen message, the equal sign (=) is 
an indication that the CODOS Disk Operating System 
has completed its previous task and awaits another. 
This is the only time when diskettes should be 
inserted or peNeved Or power removed from the 
system. 


Reset Switch Fnitialigation + aeolian 


Press the reset switch on the back of the CDX-68 Basic 
Display Terminal (the switch is in the upper right-hand 
corner of the terminal when viewed from behind). System 
Self-Test initializes the system, performs a portion of the 
selftest routine and, upon detecting that drive 0 is ready, _ 
completes the system self-test, reinitializes the system, and 

loads the CODOS Disk Operating System into memory, Seon erg 
in the following display: 


SYSTEM SELFTEST X.X 
Copyright 1979 by CODEX Corp 


Insert Disk 0 
56K memory operational 
END SYSTEM SELFTEST 


~CODOS X.x 


Note that the amount of memory or the version of CODOS may 
vary without affecting System Self-Test operation. | 
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Abort System Self-Test Function 


The Abort System Self-Test function may be entered 
immediately after the message "Insert Disk 0" is displayed, 
while SST is waiting for the operator to respond. This 
Function brings SST to an orderly conclusion and returns the 
system to CODOS. 


a. Enter a CONTROL-A (that is, press the A and CTRL 
keys Simultaneously). The system aborts System 
Self-Test and displays: 


SYSTEM SELF-TEST X.X 
Copyright 1979 by CODEX Corp 


Insert Disk 0 
END SYSTEM SELFTEST 
Waiting Drive 0 


b. Insert a diskette into diskette drive 0 and close 
the drive door. The system initializes itself, 
loads the CODOS Disk Operating System into memory, 
and displays: 


CODOS X.X 


Again, the version number of CODOS may vary without 
affecting SST operation. 


Enter CObug Function 


Note that the CObug firmware may be entered any time 
that System Self-Test is waiting for an operator response. 


a. With the CDX-68 Basic Display Terminal in one of 
the System Self-Test wait states, enter a 
CONTROL-C (that is, press the C and CTRL keys 
Simultaneously). System Self-Test initializes the 
system, goes Ee CObug, and displays: 


COBUG X.X 

* 

Note that the version number of CObug may be 
different without affecting operation. 


In the above message, the asterisk (*) is the CObug 
ready message. | 7 
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Keyboard Test 


The keyboard test function may be entered immediately 
after the message "Insert Disk " is displayed, while SST is 
waiting for the operator to respond. This function Perneee 
testing of all keyboard keys. | 


a. Enter a CONTROL-K (that is, press the K and CTRL 
keys together). System Self-Test initiates the 
keyboard test routine and displays: 


Keyboard Test 


b. Enter one at a time each of the keyboard characters 
except BREAK, ALL CAPS, AUTO LF, ON-LINE, PAGE 
MODE, and AUX PORT. The system displays each 
displayable character as it is entered and displays 
the hexadecimal equivalent of the non-displayable 
characters. 


c. Enter a BREAK eharacter to exit from this test. 
The system displays: 


‘End Keyboard Test 
Printer Test 


The printer test function may be entered immediately | 
after the message "Insert Disk 0" is displayed, while SST is. 
waiting for the operator to respond. This function permits 
testing of the system printer. | 


a. Enter a CONTROL-P (press the CTRL and P keys 
Simultaneously). The printer prints: 


SYSTEM SELF-TEST X.X | 
CORY eran: 1979 CODEX Corp. | 
I"#SZ&'()*4+,-. /0123456789:; ,<= >? @ABCDEFGHIJKLMNO 

PORSTUVWXYZ[\]_ abedef ghijklmnoparstuvwxyz{|}° 


Diskette All Sectors Read-Only Test 

This function may be entered immediately after the 
message "Insert Disk " is displayed, while SST is waiting for 
the operator to respond. This function tests not only the 
diskette drives but the diskettes themselves. 


a. Enter a CONTROL-R (press the R and CTRL keys 
together). The system displays: | 


READ Disk Test 
Depress RETURN to eonvinue: 
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b. Insert a diskette into each drive to be tested, 
close the drive doors, and press the RETURN key. 
The diskette drive reads all sectors on the. 
diskettes (2002 on a Single-sided diskette and 
4004 on a dual-sided diskette), verifies their 
CRSs, and displays: 


End Disk Test 
Depress RETURN to continue 


c. Open the door to drive 0 if the "Insert Disk 0" in 
prompt is required. Then press RETURN. If drive 0 
is closed and ready, the System Self-Test will 
continue; if successful, it attempts to load CODOS 
from the diskette in drive 0. 


Diskette All Sectors Write/Read Test 


This function may be entered immediately after the 
message "Insert Disk 0" is displayed, while SST is waiting 
for the operator to respond. This function tests all 
functions of the diskette. storage system, including the 
diskettes themselves. | | 


CAUTION! THIS TEST WILL DESTROY ALL THE DATA STORED ON THE 
DISKETTE UNDER TEST! _ | 


a. Enter a CONTROL-W (press the W and CTRL keys 
together). The system displays: 


WRITE Disk Test 
Depress RETURN to continue 


b. Insert a diskette into each drive to be tested, | 
close the doors, and press the RETURN key. The 
diskette drive writes the test pattern A55A onto 
the diskette, reads and verifies the CRC | 
Characters, and displays: 

End Disk Test 
Depress RETURN to continue 


Cc. Remove the diskettes and press RETURN. The system 
displays: a 


Insert Disk 0 


The CDX-68 BasSic Display Terminal is now ready for another 
System Self-Test or the insertion of a CODOS diskette. 
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Table 1. System Self-Test Commands 


Reyboara Entry ; | Description 
Control-A Aborts System Self-Test and. 

| bootloads CODOS immediately 
Control-C (1) | ‘Enters CObug system debugger 
~Control-K 7 | Performs the keyboard test 
Control-P Performs the printer test 
Control-R Performs the all-sectors read-only 


diskette test | 
Control-W a *s Performs the all-sectors read/write 
— diskette test _ | 


(1) This command may be entered from any System Self-Test 
wait state. The other commands can be entered only in 
an "Insert Disk 0" System Self-Test wait state. | 
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Table 2. System Self-Test Error Messages 


Message 


Console Not Ready 


‘Printer Not Ready 


MEMORY ERROR 

nnnn MEMORY ERROR 
Disk Parameter 
MEMORY ERROR 


(Bell Sounds) 


DISK ROMCRC ERRO 
nnnn instead of mmmm 


SST ROMCRC ERROR 
CObug ROMCRC ERROR 


INOPERABLE - END 
SYSTEM SELF TEST 


Probable Cause 


The CDX-68 Basic Display Terminal and 
the Microcomputer Module D failed to 
communicate. 


The Microcomputer Module D and the 
Printer Interface Module have 
interface problems. This message is 
normal when a printer is not 
connected into the system or when it 
is selected without being powered on. 


A memory error problem occurred. 


The memory was sized to a non- 
standard top-of-memory address nnnn. 


A memory problem below Memory 
location 0020 hex occurred. 


The RAM memory on the Microcomputer 
Module D was unresponsive to System 


The Microcomputer Module D, with its 


System Self-Test, cannot communicate 
with the Diskette Controller Module, 
particularly its firmware PROM. — 


This error indicates a problem with 
nnnn instead of mmmm the SST PROM. 


This error indicates a problem with 
nnnn instead of mmmm the CObug PROM. 


One of three identified failures was 
detected: 1) CObug ROMCRC ERROR; 

2) Console not ready; or 3) DISK 
ROMCRC and CObug not entered. 
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Message | . Probable Cause 


DISK ERROR #, drive | This error indicates an error with 
n, sector nnnn the diskette drive, the interconnect 


cable, or the diskette in question. 
Drive error numbers are: 


- Data CRC error 

- Diskette is write- pueucrer 
- Diskette not ready 

- Read deleted data mark error 
- Timeout error 

Invalid diskette address 

- Seek error 

- Data mark error 

- Address mark CRC error 

- System failed all-sectors 
write/read disk test 


OT OO~ID Oh WD 
| 


Waiting for Drive 0. Drive zero is not ready for 
bootloading. This message is 
generally not an indication of a 
defect; System Self-Test attempts to 
bootload CODOS when the operator 
readys drive zero. 


INTERRUPT | System disregards an unexpected 


disregarded interrupt (IRQ, NMI, or SwI) during 
us System Self-Test. 
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This chapter describes the operating procedures and 
error messages of System Self-Test for systems using 10Mb 
Disk Storage. In normal operation, System Self-Test requires 
virtually no operator effort; System Self-Test also includes 
a variety of tests and commands, used manually, that provide 
a wider range of tests. This chapter describes first the 
procedures required to test the system and operate it in 
conjunction with the CODOS Disk Operating System; each of the 
tests is then described separately. Table 3 describes each 

of the commands; Table 4 lists the error messages and their 
probable causes, 


System Reset 


System Self-Test is reset when power is first applied to 
the CDX-68 Basic Display Terminal and each time the Terminal 
reset switch (on the back of the Basic Display Terminal) is 
actuated. Both means of resetting the system are discussed 
in the following paragraphs. 


Power-On Reset and Self-Test 


a. With a cartridge disk loaded (see the 10 Mb Disk 
Storage Operator's Guide), set the PROT FIXED 
Switch to the off position and the PROT RMVBL 
switch to the on position. 


b. Apply power to the Basic pieoiay Terminal, the disk 
drive, and the system printer. Move the DISC DRIVE 
switch to the on position and then apply power to 
the system printer. The power and drive lamps on 
the Basic Display Terminal, the disk drive, and the 
printer light. After the initial warm-up delay, 
the system displays: 


SYSTEM SELF-TEST X.X_ 
Copyright 1979 by Codex Corp. 
Depress RETURN to continue 


(the X.X represents the version number). 

Note: Should the system detect an error, it 
displays the appropriate error message on 
the screen or printer (the error messages 
are listed at the end of this chapter). 


c. Depress the SELECT switch to enable the printer to 
receive data. The SELECT lamp lights. 
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~The operator now has the option of: 
Performing the System Self-Test 


Aborting the Self- -Test function and ‘boots ending the 
| CODOS Disk Operating System 


puberenG and initializing CObug 

Performing the keyboard test 

Performing the printer test 
Switch-Initiated Reset 

Press the RESET switch on. the back of the BaSic Display 
Terminal. The system aborts the operation it is eunrentey 

performing and displays: | 

SYSTEM SELF-TEST X.X 

Copyright 1979 by Codex Corp. 

Depress RETURN to continue 
The user now has the option of: 


Performing the systen Self- -Test 


Aborting the Self- ~Test function aaa boot- loading 
“ae CODOS Disk Operating System | 


Entering CObug without initialization 
Entering and initializing CObug 
Performing the keyboard test 
Performing the printer test 
System Self-Test | 
Depress the RETURN key. System Self-Test initializes 
and tests the eae and then displays: 


56K memory operation 
END SYSTEM SELF-TEST X. X 
CODOS X.X 

Or: 
56K memory operational 
Waiting for LUD 0 


Depending on whether or not the disk drive is ready (as 
indicated by the READY light on the front panel of the 
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drive). Note that the amount of memory in the above 
statement may vary without affecting operation. 


With the waiting LUD 0 output, the Terminal is in a wait 
State. The user now has the following options (in addition 
to enabling the drive): 


Aborting the System Self-Test function and 
boot-loading the CODOS Disk Operating System 


Entering and initializing CObug 

Performing the read-only test on the disk 

Performing the read/write tests on the disk 
Abort the System Self-Test Function 


This function may be entered directly after the system 
reset wait state or the "Waiting LUD 0" wait state. 


Enter a CONTROL-A (that is, press the A and CTRL keys 
Simultaneously). The system aborts the self-test function, 
loads the CODOS Disk Operating system into memory, and 
displays: 


CODOS X.X 


Enter the CObug Function 
System Self-Test can enter and initialize CObug from 
either the system reset wait state or the "Waiting LUD 0" 


wait state. 


Enter a CONTROL-C. The system jumps to CObug and 
displays: , | 


CObug X.X 
Copy EEGHt 1979 by Codex Corp. 


(as shown in the above example, the asterisk (*) is the CObug 
prompt). 
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Entering 


The 


CObug without Initialization | 


user can abort a target program, and, using the 


CObug functions, examine the contents of memory, including 


the stack. 


This function may be entered only through the > 


system reset wait state. Enter a CONTROL-B. The system 


jumps to 


Keyboard 


Ae 


CObug and displays: 


CObug X.X 


CORYERGDE, 1979 by Codex. eure 


Test 


With the system in a system reset wait state, enter 
a CONTROL-K. System Self-Test jumps to the 
keyboard test routine and displays: 


Keyboard Test 


Enter one at a time each of the keyboard characters 
except BREAK, ALL CAPS, AUTO LF, ON-LINE, PAGE 
MODE, and the AUX PORT keys. The system displays 
each displayable character as it is entered and 
displays the hexadecimal equivalent of the non- 
GeeePavieore characters. 


To exit from this test, depress the BREAK key and 
observe the message: 


End Keyboard Test 


Printer Test 


With the system in a system reset wait state, enter a 
CONTROL-P from the keyboard. The printer prints: 


SYSTEM SELF-TEST X.X 

Copyright 1979 CODEX Corp 

I"#S3&'() -*+,- -/ 0123456789: ; <= > 2ABCDEFGHIJKLMNO 
PQRSTUVWXYZ[\] “_ *abcdefghijklmnopgqrstuvwxyz{\} 
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Read-Only Disk Test 


a. With the system in a "Waiting LUD 0" state, enter a 
CONTROL-R. The system displays: 


Read Disk Test 
Depress RETURN to coneanuc 


b. Ready those disk drives (LUDs) that are to be 
tested and then press RETURN. The system reads all 
sectors on all ready LUDs and displays 


End Disk Test 
Depress RETURN to continue 


Read/Write Disk Test 


ae Ready those disk drives (LUDs) which are to be 
tested and then press RETURN. The system displays: 


Write Disk Test | 
Depress RETURN to continue 


-b. Enter a RETURN character. The system performs a 
two-surface read/write test on sectors 23 and 24 of 
all ready LUDs and displays: 


End Disk Test 
Depress RETURN to continue 


c. If System Self-Test is to continue to completion, 


ready LUD 0 before depressing RETURN. Otherwise, 
depress RETURN to go to the "Waiting LUD 0" state. 
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Table 3. System Self-Test Commands 


(for disk-based systems) 


Keyboard Entry Description 


CONTROL-A (Note 2)  Aborts System Self- Test and boot-loads 
CODOS immediately | | 

CONTROL-B (Note 2) Enters CObug without initialization 

CONTROL-C (Note 1) Enters and initializes CObug 

CONTROL-K (Note 2) Performs ene keyboard test 

CONTROL-P (Note 2) Performs the prinber test 

CONTROL~-R (Note 3) Performs the all- ~gector read-only disk 


test on all ready LUDS. 


CONTROL-W (Note 3) Performs the two-surface read/write 
| disk test on all ready LUDs. 


Note 1: May be entered in any wait state. 


Note 2: May be entered only after power is applied or the 
RESET switch on the back of the Basic Display 
Terminal is actuated (the "Depress RETURN to 
continue" state). 


Note 3: May be entered only after the RETURN key has been 
pressed and the Terminal Screen is displaying 
"Waiting LUD 0." 


Table 4. System Self-Test Error Messages 


Message | Probable Cause 


SST ROMCRC ERROR This indicates an error with the SST 
EPROM. | 


Console Not ready The CDX-68 Basic Display Terminal and 
the Microcomputer Module D failed to 
communicate, 7 


PRINTER NOT READY The Microcomputer Module D and the 
| CDX-SP series printer have interface 
problems. This message is normal when 
the system has no printer or if the 
printer is not powered on while 
selected (placed on-line). 
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Message 


MEMORY ERROR 

nnnn MEMORY ERROR 
Shared MEMORY 
ERROR 


Disk Parameter 
MEMORY ERROR 


Bell Sounds 
Continuously 


DISK ROMCRC ERROR 


INOPERABLE- END 
SYSTEM SELF-TEST 
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Probable Cause 


A memory error problem occurred. 


The memory was Sized to a non-standard, 
top-of-memory address nnnn, 


The 10 Mb Disk Controller Shared Memory 
Module failed its memory test. 


A memory problem occurred below memory 
location 0020 hex 


Microcomputer Module D RAM memory was 
unresponsive to System Self-Test. 


The Microcomputer Module D, with its 
system Self-Test firmware, cannot 
communicate with the Disk Controller 
Interface Module, particularly its 
firmware PROM. 


One of three identified failures 
detected: 1) CObug ROMCRC ERROR, 
2) Consoles not ready, 3) DISK 
ROMCRC and CObug not entered. 
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Message _ Probable Cause 


DISK ERROR #, This error indicates an error with the 
LUD n, - disk drive, the interconnect cable, or 
sector nnnn the disk in question. LUD error 


numbers are: f 
0 - No errors, normal return status 
~- Data CRC error 

- Header write protect error 

- LUD not ready 

- Header bad sector indicator 

- Disk operation not complete 
Invalid disk address 

- Seek error 

- Compare error 

- Data or control FIFO error 

- Data buffer location error 

- Read or write error at sector time 


ww ee (OONAN UBD WH MH 
I 


CObug ROMCRC ERROR This error indicates a problem with the 
CObug PROM or, alternatively, that the 
PROM is not available. | 


Waiting for LUD 0 Drive zero is not ready. This message 
? is not generally an indication of a 
defect (usually, the drive is not yet 
on-line). System Self-Test attempts to 
boot-load CODOS as soon as the operator 
readys drive 0. 


INTERRUPT _ - System disregards an unexpected — 
Disregarded interrupt (IRQ, NMI, or SWI). 
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CHAPTER 4. INTRODUCTION 


CObug 1S a comprehensive, easy-to-use software 
development and debugging tool. Designed for use with Codex 
Intelligent Terminal Systems, CObug provides a full set of 
memory test and Input/Output subroutines. These subroutines 
may be executed in a stand-alone mode to test for specific 
conditions or to examine the operation of a specific program; 
they may also be incorporated into uSer programs (an entry 
jump table provides access to the different subroutines). 


An interactive program, CObug permits users to select 
different options through the keyboard of the CDX-68 Basic 
Display Terminal; the results of the subroutine may be viewed 
on the Terminal's display screen or directed to a system 
printer for hard-copy output. CObug resides in a 2K-byte 
firmware module that plugs into the microcomputer module of 
the Codex Intelligent Terminal System. | 

CObug features include: 

Interactive access 


Provides debug and basic input/output ae aaa to 
the CDX-68 Basic Display Terminal 


Provides easy user access to Babveucmies 
Provides 12 user commands — 


In addition, CObug permits the user to perform the following 
functions: 7 : : 


load the CODOs Disk Operating System into system 
memory 


display, and, if required, change se eased of 
memory — | 


display, and, if required, change the contents of 
the MPU's registers 


set breakpoints 

display breakpoints 
remove breakpoints singly 
remove all breakpoints 


continue running the target program from the 
current location 
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go to specified location and begin running the 
target program 4 | 


restart the system Self-Test 


Print the contents of memory in both hexadecimal 
and ASCII form 


CObug is interactive, allowing the user to communicate 
with it through the CDX-68 Basic Display Terminal, In 
addition, the user can easily incorporate CObug subroutines 
into his applications programs. The user gains access to 
these subroutines through entry points listed in a jump > 

table; these subroutines are described in Chapter 7. 


~CObug Installation > 


CObug is shipped either installed (in socket U13 of the 
Basic Display Terminal's Microcomputer Module D) or 
separately (as a replacement part). In the latter case, 
CObug iS shipped in conductive foam to protect the chip from 
static electricity. To install the replacement PROM, remove 
any PROM already in socket U13 on the terminal's 
Microcomputer Module D, insert this PROM in Ene conductive 
foam, and install the new PROM in the socket. 


CAUTION: The CObug PROM is susceptible to damage from 
Static electricity and improper handling. 
Store this PROM (and all others) in conductive © 
foam when not in place on the circuit board. 
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CHAPTER 5. CObug COMMANDS 


This chapter discusses the CObug commands. These 
commands are listed in Table 1 and discussed in the following 
paragraphs. Any of these commands may be entered when CObug 
is displaying its prompt. No CARRIAGE RETURN entry is 
required to initiate a command. All parameters entered are 
assumed to be hexadecimal values. 


Invoking CObug (diskette-based systems) 


The System Self-Test (SST) program for diskette-based 
systems provides the user with a command to enter CObug. For 
detailed information on SST and its operation, see the first 
part of this Guide. 


CObug may be entered from SST by entering the command 
CTRL-C (that is, pressing the CONTROL and C keys 
Simultaneously) at any SST wait state. For example: 


a. After applying power to all terminal system components, 
open the door of diskette drive number zero (the 
left-most drive) and press the reset switch on the back 
panel of the Terminal. Upon detecting no errors, the 
system cteplaye: an. | : ie 


SYSTEM SELF-TEST X.X 
Copyright 1979. by Codex Corporation 
Insert Disk 0. 


b. Instead of readying drive 0, enter a CONTROL-C (press 
the CTRL and C keys simultaneously) to enter and 
initialize CObug. CObug displays: 


CObug X.X 
- | 


where the asterisk (*) is the CObug prompt (that is, 
CObug has finished its previous task and awaits 
another). | 


CG, In addition, any time System Self-Test is awaiting an 
operator response (when any "Depress RETURN to continue" 
message is displayed), entering a CONTROL- C causes the 
system to enter CObug. 


d. CObug may also be engaged by entering the command 
"COBUG" in response to the equal sign (=) prompt 
displayed by the CODOS Disk Operating System (CObug is 
part of the System Test and Diagnostic package). 
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e@. Some special CDX-68 systems have an ABORT button on the 
front panel or an NMI switch located on the rear panel. 
Depressing either of these switches causes the system to 
enter CObug (providing the interrupt table is intact). 


£. © CObug may be entered under software control using the 
START entry (equivalent to the CTRL-C command) or the 
NMI entry (equivalent to the CTRL-B command). 


Invoking CObug (disk-based systems) 


The System Self-Test (SST) program for disk-based 
systems provides the user with two commands to enter CObug. 
Each is described below. 


As an aid to distinguishing the two means of entering 
CObug, remember that CONTROL-C restarts CObug and executes 
all CObug initialization code before performing the debug 
function. CONTROL-B (CObug without the initialization of the 
complete CObug function) assumes that CObug has been 
previously initialized and goes to the delay function. If 
CObug has not been initialized since the last time power was 
turned on (SST does this if allowed to run interrupted), then 
depressing CONTROL~B will produce undefined results. 


For detailed information on the CDx- SST/D System | 
Self-Test Firmware and its operation, refer to the first part 
of this Guide. 


Uninitialized cobug Starting (disk- ~based systems) 


To start CObug when it has not been previously 
initialized: 


ae Reset the CDX-68 Basic Display Terminal (the Terminal is 
reset when power is first applied or when the reset 
button on the rear panel is actuated). Upon Ceceatang 
no errors, the system displays: | 


SYSTEM SELF TEST X.X 
Copyright 1979 by Codex li a 
Depress RETURN to continue 


b. ineeesa of incain the RETURN key to continue SST, 
the operator may enter a CONTROL-C (the CTRL and C keys 
depressed simultaneously) to enter and evens 
CObug. CObug then displays: | 


CObug 5.0 
* ea 


System Self-Test/CObug User's Guide _ | Page 5-02 


CObug Commands — Uninitialized CObug Starting (disk-based systems) 


where the asterisk (*) is the CObug prompt (that is, 
CObug has finished its previous task and awaits 
another). 


Cy In addition, any time System Self-Test awaits an 
operator response (any time the "Depress RETURN to 
continue" message is displayed), CONTROL-C may be 
entered to engage CObug. 


d. CObug may be engaged by entering the command "GOCOBUG" 
in response to the CODOS equal sign (=) prompt (CObug is 
part of the System Test and Diagnostic package). 


Initialized CObug Starting (disk-based systems only) 
Running CObug starting 


In the running start of CObug, CObug does not initialize 
itself before performing its debug function. This permits a 
user to abort a program, and using CObug, to examine memory 
locations which would otherwise have been changed by the 
CObug initialization. 


a. Actuate the reset switch located on the rear panel of 
the CDX-68 Basic Display Terminal. The system displays: 


System Self-Test X. x 
Copyright 1979 by Codex Corporation 
| Poehees RETURN to continue | 


b. Enter a CONTROL-B bali es ta CTRL and B keys 
depressed simultaneously). The system displays: 


cobug X.X 
COeveLaue: 1979 by Codex Corporation 


On specially-equipped CDX-68 systems, use of the ABORT or NMI 
buttons can cause control to immediately enter CObug | 
(equivalent in effect to the CTRL-B command). When debugging 
a target program, this circumvents the need to enter CObug by 
way of System Self-Test. 
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Table 5. CObug Commands 


Command 


PRNT 


LOAD 
RSTR 
n/ 


n/m c 


LF 


SV 


SR 
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Execution 


Print memory in both _ 
hexadecimal and ASCII format. 


Load CODOS. 

Restart the system self test. 
Display contents only. 
Display contents of 

memory (CObug displays 


memory "m") and then 
replace contents with "c." 


Open the next sequential 


location to n. 


Open the previous location 
to n. 


Close the open location. 


Return to the CObug scanning 


Set a breakpoint at 
location n,. | 


Remove all breakpoints. 


Remove the breakpoint at 
location n. 


Execute the target program 
at n. 


Continue executing from 
encountered breakpoint. 


Display all breakpoints. 


Display/change registers. 
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Print Command (PRNT) 


This command prints the specified portion of the current 
memory map in both hexadecimal and ASCII forms. 


a. Enter the word PRNT. The system displays: 
BEG ADR nnnn on the next line. 


Note: The nnnn is the beginning address used 
in the previous PRNT function; if it does not 
need to be changed, enter a CR. 


b. Enter in hexadecimal the selected beginning address 
and a CR. (Leading zeroes need not be entered.) 
CObug stores the entered address and displays: 


END ADR nnnn 


Note: The nnnn is the ending address used in 
the previous PRNT function; if it does not 
need to be changed, enter a CR. 


c. Enter in hexadecimal the selected ending address 
anda CR. The system now tests whether the ending 
address is larger than Phe peg ning address. 


1. If the ending address is smaller, the system 
: displays the Fost OWwsNS message. Proceed to 
step a. | 


BEG ADR nnnn 


2. If the starting address is smaller, the system 
displays: 


ON PRT 


d. Enter a "Y" to send the display to the printer, an 
"X" to abort the function and return to the CObug * 
(note that this is the only way to exit this 
function), and enter anything else to send the 
display to the display screen. The system prints 
or displays the memory contents as appropriate and 
then displays: 


BEG ADR nnnn 
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e. Proceed to step be 


Note: Entering a CONTROL-W while the 
memory contents are being displayed causes 
the display to wait at the end of the 
current line until some oEnee character is 
entered. 


Load Command (LOAD) 


Enter the word LOAD. The system loads the CODOS Disk 
Operating System into system memory and displays the 
following message: 


CODOS X.X 


where the equal sign (=) is the CODOS prompt. 
Restart Command (RSTR) 


With all disk drives off-line, enter the command RSTR. 
This command returns the system to System Self-Test. At this 
point, it is similar to when the equipment was just powered 
up or as if the reset switch on the back of the Basic Display 
Terminal had been actuated. ‘Refer to "Invoking CObug," 
above. | 


Memory Examine and Change Command 


CObug performs this command: in three eteoss examining 
the contents of a selected memory location (opening the | 
memory location), changing the contents of this memory 
location if required, and closing the memory location. 


a. Enter the address of the memory location to be 
examined and a / (slash) character. CObug reads 
the memory location and displays the contents in 
hexadecimal. 


Note: If the memory contents are not to 
be changed, EEerce? to step c. 


b. If the contents of the memory location are to be 
changed, enter (in hexadecimal) the new data to be 
stored at this location. 


The operator now must decide in cloSing this memory 
location whether to return to CObug control 
program, to examine the previous sequential memory 
location, or to examine the following sequential 
memory location. 
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c. Perform one of the following substeps and close 
this memory location. 


l. Enter a CR charketer, CObug closes the present 
memory location, returns to its control | 
program, and displays an asterisk on the next 
line. 

2. Enter an *~ (Up Arrow) character. CObug closes 
this memory location and examines the previous 
sequential memory location. The system now 
displays the previous memory address, a slash, 
and the contents of this memory location. 
Return to step b. 


3. Enter a LF (Line Feed) character. CObug closes 
this memory location and examines the next 
sequential memory location. The system now 
displays the new memory address, a slash, and 
the contents of this memory location. Return 
to step b. 


Insert, Display, and Remove Breakpoint Command 


These commands enable CObug to insert up to eight 
breakpoints in a target program, to display the breakpoints 
on command, and to remove the breakpoints. The breakpoint 
sequence 1s: ho 


User designates the breakpoint (s') address(es) 
User initiates the execute function 


CObug replaces the program instruction(s) with 
breakpoint(s) and executes the target program 


On detecting a breakpoint, the system returns to 
CObug. | 


CObug inserts the program instruction and the 
system displays the contents of the MPU registers. 


NOTE: If the user should initiate the 
execution from an address where a 
breakpoint is set; that breakpoint 
will not be established in memory, — 
but all other breakpoints will be 
in memory. This is done to prevent 
looping on a breakpoint. 
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Entering a Breakpoint (nv) 

a. Enter the address (n) of the sexeceea Weeaooiae: a 
semicolon, and a v. CObug enters the breakpoint in 
the target program, returns to its control program, 
and displays an asterisk. | 


Displaying all Breakpoints (SV) 

b. Enter the character $V. CObug displays all the 
breakpoints, returns to itsS control program, and 
displays an asterisk. : 


on a ee ew em ae eOm GE Gee GER aEe GMs ene Ge EEE GED Et ee Ge ee ee ee OD Gee Ce oo Gee we Ge om Om oe 


The user has the option of removing just one 
breakpoint (step c) or of removing all the 
breakpoints at one time (step d). 


c. TO remove a aac peeaiepa its enter the address 
| (n) and the character ;U (Semicolon U). CObug | 
removes this breakpoint and displays an asterisk. 


d. To remove all the breakpoints, enter the characters 
7;U (semicolon U). CObug removes all the 
breakpoints and displays an asterisk. 


Target Program Execution Commands 


The user has the option of selecting whether he wants to 
start running the target program from an address given in the 
command or from the present target program address (program 
counter address). Refer to Table 6 and enter the appropriate 
command. | 


Table 6. Target Program Commands 


Command Function 
n;G Set the program counter to address 
, n and start executing Ene target 
program. 
;P Start from the present program. 


counter address and continue 
executing the target program. 


n;P Start from the present program 
| counter address, and if a 
breakpoint is set at this address, 
establish a bypass of n-l. 
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The system executes the target program until one of the 
following conditions has been reached: 


An SWI MPU instruction is detected. 
A WAL MPU instruction is detected. 


The system ‘RESET Switch on the back of the Basic 
Display Terminal is actuated. 


Display Contents of MPU Command 


This function enables CObug to display the contents of 
the system M6800 MPU registers for examination and change. 


a. Enter the characters SR. The system displays the 
contents of the MPU registers in the following 
sequences: program counters, index register, A 
accumulator, B accumulator, condition code 
register, and stack pointer. 


b. If the contents of an MPU register are to be 
changed, enter the new hexadecimal value after the 
current value is displayed. 


c. Enter RETURN to exit this sequence and go 
immediately to the next asterisk (*) prompt. Enter 


RETURN only to leave the current value unchanged 
and exit. Enter anything else to continue. 


CObug Error Messages 
NO CHANGE 


Memory change is attempted on memory out of range or on 
read-only memory. 


BEEP (bell sound) 
General error response that appears when incorrect forms 
of commands are entered, commands are entered at 
inappropriate times, or commands are unknown. 

NO BKPTS SET 
May appear in response to the SV command. All 
breakpoints have been removed by use of the ;U command 


or an attempt has been made to set a breakpoint at an 
undefined location. 
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 RDY DSK 


The disk was not ready when a LOAD command was 
attempted. CObug returns to its asterisk prompt. 
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CHAPTER 6. CObug SUBROUTINES 

This chapter discusses the CObug subroutines. Table 7 
identifies each subroutine while the following paragraphs 
describe the subroutines in detail, including call, required 
subroutine inputs, and subroutine outputs. 


Table 7. CObug Subroutines 


Function 


Addr Mnemonic 


F000 START Restart CObug monitor 
F003 BEGEND Get begin and end addresses 
F006 CBCDHX Convert ASCII hex to binary 
F009 CHEXL Convert 4MSB to ASCII hex 
FOOC CHEXR Convert 4LSB To ASCII hex 
FOOF INADDR Get hex address 
indirect (X) 
FO12 INCH Receive one character 
FO15 INCHNP Receive one character 
: no parity 
FO18 OUTCH Send ASCII character 
FO1B OUT2HS Display 2 hex 
characters followed 
by a space (X) 
FOLE oOUT4HS Display 4 hex 
| | Characters followed 
by a space (X) 
FO2] PCRLF Display a CR and LF 
F024 PDATA Display a CR, LF, 
anda string (X) 
F027 PDATA1 Display a data string (X) 
FO2A PS PACE | Display a space 
FO2D BYTE Receive a hex byte 
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6-01 


F030 


F033 
F036 
F039 


FO3C_ 


FO3F 


FQ 42 


FQ45 


F048 


FO4B 
FO4E 
FO51 


F054 


FO57 


FOSSA 
FO5D 


F060 


F063 
F066 


F069 
FO6C 


LPINIT 


LIST 


LDATA 


-LDATA1 


CONTRL 
CKBRKK 


NMI 


REMSWI 


INZMRO 


SFE 
OUT2HD 
OUT4HD 


PCR 


-MRC2 


MRC4 


SWAPHL 


~ PCHDA 


PREGS 


INAD20 


RBRS 


SETB 


Initialize the printer PIA 


Print character in (A). 


Print data string (X) 
Print CR, LF, data (X) 
Return to CObug 

Check for BREAK key 


NMI entry point 
(ABORT) 


Return to CObug monitor & 


Switch SWI vector to 
point to CObug monitor 
SWI handler 


Jump vector to 
initialize CObug 
monitor RAM only 


Jump vector for the CObug 


monitor SWI handler 


Display two hexadecimal 


characters and a / 


Send four hexadecimal 
characters and a / 


Display a carriage return 


Change one byte | 
Change double byte 
Swap high and low bytes 


Display a character from 


A and dash 


Display registers 


Continue input with 
second character 


Remove breaks 


Set break points 
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FO6F INADD Input hexadecimal 
characters | 


F072 MEMTST Random noise memory 
test (operator- 
supplied addresses) 


———= MEMT1 Random noise memory 
test; addresses 
Supplied in locations: 
EF80 and EF81 (beginning) 
EF82 and EF83 (ending) 
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BEGEND | 


(get beginning andi ending addresses) 


Functions: | 
Requests the input of the beginning and ending address 
as defined in the random noise MEMORY TEST functions. 
Verifies that inputs are hexadecimal characters; also 


verifies that the a el address is smaller than the 
ending address. 


Call: 

JSR BEGEND 
Subroutine. Input: 
None. 
Subroutine Output: 


EF80 BEGA 16-Bit 
Beginning address 


EF82 ENDA 16-Bit 
Ending Address 


Comments: 
Accumulator A and B, along with the index register, are. 
used by this subroutine. If their contents are | 


meaningful, they must be saved prior to calling this 
Subroutine. 
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CBCDHX 


(convert an ACSII hexadecimal character to a binary 
number ) 


Functions: 


Verify the input character is a hexadecimal digit 
character. Converts the character to a 4-bit binary 
number with the four high-order bits equal to zero. 
Sets N (negative) condition for non-hexadecimal 
characters. 


Call: 
JSR CBCDHX 
Subroutine Input: 
Character to convert must be in Accumulator A. 
Subroutine Output: 
Accumulator A contains the 4-bit binary number 
represented by the input character and the N (negative) 
condition code is cleared. If input is not a 
non-hexadecimal character, accumulator A contains the 


character input and the N (negative) condition code is 
set. The B and X registers are preserved. 
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CHEXL 


(convert four most significant oars to ASCII 
hexadecimal) — 


Function: 


Converts the four most Siontereant bits of accumulator 
A to an ASCII-coded hexcadecimal digit character. 


Call: 

JSR CHEXL 
Subroutine Input: 

Contents of Accumulator A. 
Subroutine Output: 


An ASCII-coded hexadecimal digit character in 
accumulator A. The B and X registers are preserved. 
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INADDR 


(get hexadecimal address indirectly) 


Function: 


Converts up to four input hexadecimal characters to a 
16-bit binary address. 


Call: 
JSR INADDR 
Subroutine Input: 


The index register contains the address of where to 
store the result. | 


Subroutine Output: 


Eight most significant bits of 16-bit address are 
stored into the memory location specified by the index 
register. The eight least significant bits are stored 
into the next higher memory location. Accumulator A 
contains last character received. Accumulator B 
contains the number of hexadecimal characters received. 
The index register is unchanged. The subroutine 
returns to the calling program when an invalid 
Character, or the fifth hexadecimal digit, is entered. 


System Self-Test/CObug User's Guide | Page 6-07 


INCH 


(put one character into Accumulator A), 


Function: | 


Wait for and accept the input of one character from the 
CDX-68 Basic Display Terminal; if enabled echo one 
character back. | | | | : 


Call: 
JSR INCH 
Subroutine pe ad | 
There is a no-echo flag (AECHO) at EF99. It must be 


set to other than zero before each call to INCH (for 
each character that is not to be echoed to the CDX-68). 


Subroutine Output: 


Accumulator A contains an 8-bit input character as 
received from the CDX-68. The B and X registers are 
preserved. | | | 
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INCHNP 


(receive one character with no parity) 


Function: 


Wait for and accept the input of one character from the 
CDX-68 and, if echo is enabled, echo the character back 
to terminal. Clear the high-order bit (parity) of the 
input character. | | 


Call: 
JSR INCHNP 
Subroutine Input: 
There is a no-echo flag (AECHO) at EF99. It must be 
set to other than zero before each call to INCHNP for 
each character that is not to be echoed to the CDX-68. 
Subroutine Output: 
Accumulator A contains the input character as received 
from the selected input with the high-order bit 


cleared. INCHNP appears as AECHO if it was not zero. 
The B and X registers are preserved. 
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OUTCH 


(send ASCII character from Accumulator A) - 


Function: 


Send one character to the CDX-68 Basic Display 
Terminal. a | | 


Call: 
JSR OUTCH 
Subroutine Input: 


Accumulator A contains the character to be sent to the 
CDX-68 terminal. | | 


Subroutine Output: 


Accumulator A contains the character sent. The B and X 
registers are preserved. : | | 
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OUT2HS 


(print two hexadecimal characters and a space) 


Function: 
Converts the contents of an 8-bit binary byte to two 
hexadecimal characters and sends these converted 


characters, followed by a space character, to the 
CDX-68 Basic Display Terminal. 


Call: 
JSR OUT2HS 


Subroutine Input: 


The index register contains address of the byte to be 
converted and sent. 


Subroutine Output: 


Accumulator A contains the last character sent. The B 
accumulator is preserved and the X ESgTeter is 
incremented by one. 
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OQUT4HS 


(print four hexadecimal characters and a space) 


Function: 
Convert the contents of two consecutive 8-bit bytes to 
four hexadecimal characters and sends the converted 


characters, followed by a Peaeee to the CDX-68 Basic 
Display Terminal. | 


Call: 
JSR OUT4HS 
Subroutine Input: 


The index register contains the address of the first 
byte to be converted and sent. | 


Subroutine output: 
Accumulator A contains the last character sent. The 


index register contains the input address plus two. 
The B accumulator is preserved. 
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PCRLF 


(print a carriage return and line feed character) 


Function: 


Sends a Carriage Return (CR), a Line Feed (LF), and a 
Null character to the CDX-68 Basic Display Terminal. 


Call: 

JSR PCRLF 
Subroutine Input: 
None. 
giproneene Output: 


Accumulator A contains a Null character (0). The B and 
X registers are preserved. 7 
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PDATA 


(print a carriage return and line feed string) 


Function: 


Sends a Carriage Return (CR), a Line Feed (LF), and a 
user-specified string of data characters to the CDX-68 
Basic Display Terminal. 


Call: 
JSR PDATA 

Subroutine Input: 
The index register contains the starting address of the 
user data string to send. The output string is 


terminated by an EOT a Characrers 


Subroutine Output: 


The index register contains the address of the EOT 
Character. Accumulator A contains the EOT character. 
The B accumulator is preserved. 
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PDATAL 


(print string of characters) 


Function: 


Sends a user-specified string of data characters to the 
CDX-68 Basic Display Terminal. 


Call: 
JSR PDATAIL 


Subroutine Input: 


The index register contains the starting address of the 
user data string to send. The output string is 
terminated by an EOT (04) character. 


Subroutine Output: 


The index register contains the address of the EOT 
character. Accumulator A contains the EOT character. 
Accumulator B is preserved. 
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PSPACE 


(print a space) 


Function: 


Send a space character to the CDX-68 Basic Display 
Terminal. | | | 


Call: 

JSR PSPACE 
Subroutine Input: 
None. 
Subroutine Output: 


Accumulator A contains a space character. The B and X 
registers are preserved. | 


System Self-Test/CObug User's Guide ; Page 6-16 


BYTE 


(enter hexadecimal byte) 


Function: 
Obtains two hexadecimal characters and converts them to 
binary, checking each character for non-hexadecimal 
composition. 

Call: 
JSR BYTE 

Subroutine Input: 
None. 


Subroutine Output: 


Accumulator A is added to Accumulator B, with the 
results residing in Accumulator A. 


System Self-Test/CObug User's Guide Page 6-17 


LPINIT 


(initialize the line printer) 


Function: 
Prepares the line printer for reception of data. 
Call: | 
JSR LPINIT 
Subroutine Input: 


The index register contains the contents of the address 
holding the data. | | 


Subroutine Output: 


The contents of Accumulator A, indicating status input, 
are stored in the PIA. — | 
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LIST 
(transfer character in Accumulator A to the line 
printer) | | : 
Function: 


Prints the character from Accumulator A and checks for 
printer error. 


Call: 
JSR LIST 
Subroutine Input: 


Stores the contents of Accumulator A, containing data, 
into PIA. 


Subroutine Output: 


The contents of Accumulator A are sent to PIA. 
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LDATA 


(send data string to line printer) 


Function: 
Prints a data string, carriage return, and line feed. 
Call: | 
JSR LDATA 
Subroutine Input : 


Data string, carriage return, and line feed are sent to 
the printer in sequence from Accumulator A. | 


Subroutine Output: 


The carry bit is cleared. Accumulator A is checked ec 
determine if all data has been sent. a 
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LDATAL 


(print data string to EOT) 


Function: 

Print the data string in its entirety. 
Call: 

JSR LDATA1] 
Subroutine Inputs: 


The index register contains a pointer to the data 
string. 


Subroutine Output: 


The carry bit in the condition code register is 
Cleared. | : | 
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CONTRL 


(return to CObug) 


Function: 

Returns to Cobug upon system start-up or interrupt. 
Call: — 

JSR CONTRL 
Subroutine Input: 


The index register LSB is zero; the non-SWI flag is 
set. | 


Subroutine Output: 


Jump is made to CObug.. 
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CKBRKK 


(check for BREAK or CONTROL key) 


Function: 


Check the system to determine if the BREAK or CTL-W 
keys were pressed. 


Call: 
JSR CKBRKK 
Subroutine Input: 
None. 
Subroutine Output: 
The condition code carry indicator is set if the BREAK 


key is pressed. The A, B, and X registers are 
preserved. | 
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NMI 


(non-maskable interrupt handler) © 


Function: 
Processes non-maskable interrupts, saves user stack 
upon entry, sets up the CObug stack, removes all 
breakpoints, and prints the contents of all registers. 
Call: | 
JSR NMI 
Subroutine Input: 
The stack contains the program counter values. 


Subroutine Output: 


Breaks are removed and the registers are printed by 
Subroutines. 7 | 
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REMSWI 
(return to monitor and SWI vector to monitor SWI 
handler ) | 


Function: 


Returns the system to CObug control by printing the SWI 
vector to CObug's SWI handler. 


Call: 

JSR REMSWI 
Subroutine Input: 

The index register is Peaded with the SWI vector. 
Subroutine Output: 


The pointer from the SWI vector to CObug's SWI handler 
1s stored and system control is returned to CObug. 
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INZMRO 


(jump vector to initialize CObug monitor RAM only) 


Function: 


Creates a jump vector to initialize the CObug the RAM 
and initializes the SWI and NMI vectors. 


Call: 
JSR INZMRO 
Subroutine Input: 
None. 
Subroutine Output: | 
If INZMRO was entered directly (uSing a JSR), a return 
to the caller is made. If INZMRO was entered using the 


Start routine, START execution continues after INZMRO 
is complete. 
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SFE 


(jump vector for the CObug monitor SWI handler) 


Function: 


Creates a jump vector for the CObug SWI handler and 
sets the SWI flag. | 


Call: 

JSR SFE 
Subroutine Input: 
None. 
Subroutine Output: 


A branch is made to CObug processing. 
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OUT2ED 


meen’ Hic haxsdncivnd characters pee a diagonal) 


Function: 

Converts the contents of a binary byte to two 
hexadecimal characters and sends them (followed by a 
diagonal). 

Call: 
JSR OUT2HD 

Subroutine Input: 


The index register contains the addresses of the bytes 
to be converted. 


Subroutine Output: 


The index register is incremented by one. Accumulator 
A contains the diagonal. 
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OUT4HD 


(send four hexadecimal characters plus a diagonal) 


Function: 
Converts the contents of two consecutive binary bytes 
to four hexadecimal characters and sends them (followed 
by a diagonal). 

Call: 
JSR OUT4HD 


Subroutine Input: 


The index register contains the addresses of the bytes 
to be converted. 


Subroutine Output: 


The index register is incremented by two; Accumulator A 
contains the diagonal. | 
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PCR 


(send a carriage return) 


Function: | 
Prints a carriage return. 
Call: 
JSR PCR 
Subroutine Input: 
Accumulator A is loaded with the carriage return. 
Subroutine Output: 


Accumulator A is cleared. 
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MRC2 


(change one byte) 


Function: 

Changes a single byte at a designated address. 
Call: 

JSR MRC2 
Subroutine Input: 


The designated address OPENCL loaded from index 
register. | 


Subroutine Output: 


Accumulator B is cleared, and the index register is 
again loaded from the designated address. 
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MRC4 


(change double byte) 


Function: 

Changes a double byte at a designated address. 
Call: | | 

JSR MRC4 
Subroutine Input: 


The designated addresses OPENCL and OPENCL + 1 are 
loaded from the index register. | | 


Subroutine Output: 


Accumulator B is cleared and the index register is 
again loaded from the designated address. _ 3 
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SWAPHL 


(swap high and low bytes) 


Function: 


Exchanges the contents of the memory location pointed 
to by the index register. 


Call: 
JSR SWAPHL 
Subroutine Input: 
The index register is loaded with PRPCH. 
Subroutine Output: 
The index register plus one contains the contents of 


Accumulator A. The index register contains contents of 
Accumulator B. | | 
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PCHDA 


(send character from Accumulator A and a dash) 


Function: 


Prints the character that is stored in Accumulator A 
and the dash character. | 


Call: 
JSR PCHDA 


Subroutine Input: 


Accumulator A is loaded with the dash character. 


- Subroutine Output: 


A jump to the subroutine-to output-character is made. 
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PREGS 


(display registers) 


Function: 


Prints the contents of all registers plus a carriage 
return and line feed. 


Call: 
JSR PREGS 
Subroutine Input: 


The index register loaded with the pointer-to-program 
registers (PRPCH; memory). 


Subroutine Output: 


Branches are made to send characters from Accumulator 
A. 
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INAD20 


(Continue input with the second character) 


Function: 


The input address is returned with the last character 
received and the number of hexadecimal characters 


received. | 
Call; 

JSR INAD20 
Subroutine Input: 


Accumulator B contains the number of hexadecimal 
characters to be received. | 


Subroutine Output: 


Accumulator A contains the last character received. 
Accumulator B contains the number of hexadecimal 
character received. — 
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RBRS 


(remove breakpoints) 


Function: 


Removes breakpoints, pentose instructions, and resets 
the breakpoint flag. 


Call: 

JSR RBRS 
Subroutine Input: 
None. 
Subroutine Output: 


None. 
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INADD 


(put hexadecimal address into memory; 16-bit address) 


Function: 


Receives a sequence of hexadecimal characters to make 
an address. | 


Call: 
JSR INADD 


Subroutine Input: 


The index register loaded with 16-bit address in 
memory. : 


Subroutine Output: 


Accumulator B contains the hexadecimal character count. 
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MEMTST and MEMT] 
(random noise memory test) 


Function: 
Tests the system memory bounded by the beginning 
address BEGA and ending address ENDA and produces error 
messages as required. If entered at MEMTST, the 
Operator is requested to enter these addresses (See the 
description of the PRNT command). If entered at MEMT1, 
it 1S assumed that these are already present in BEGA 
and ENDA. 

Call (MEMTST) : 
JSR MEMTST 

Call (MEMT1) : 


LDX SF073 
TSR 3,X 


Subroutine Input: 


If entered at MEMT1, it is assumed that these are 
already present in BEGA and ENDA. 


Subroutine Output: | 
The memory location BEGA (EF80) contains the 


start-of-memory address. The memory location ENDA 
(EF82) contains the end-of-memory address. 
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